Skip to content

docs: Cloud users refactor#4249

Open
lennessyy wants to merge 12 commits intomainfrom
cloud-users-refactor
Open

docs: Cloud users refactor#4249
lennessyy wants to merge 12 commits intomainfrom
cloud-users-refactor

Conversation

@lennessyy
Copy link
Contributor

@lennessyy lennessyy commented Feb 27, 2026

What does this PR do?

Refactors the user access section. Introduces new page /roles-and-permissions

Notes to reviewers

┆Attachments: EDU-5960 docs: Cloud users refactor

@vercel
Copy link

vercel bot commented Feb 27, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
temporal-documentation Ready Ready Preview, Comment Feb 27, 2026 2:56am

Request Review

@github-actions
Copy link
Contributor

github-actions bot commented Feb 27, 2026

@lennessyy lennessyy marked this pull request as ready for review February 27, 2026 02:05
@lennessyy lennessyy requested a review from a team as a code owner February 27, 2026 02:05
| Global Admin | Administers account configuration and users | Yes | All Namespaces (cannot be revoked) | Usage only |
| Developer | Creates and manages Namespaces they own | Yes | Namespaces they create (can be revoked) | None |
| Finance Admin | Manages billing and payment information | No | None | Full billing and payments |
| Read-Only | Views account configuration and resources | No | None | None |
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I removed the massive API level table because I think they go stale quickly and are hard to maintain, and instead wrote a high-level table. I think we should link to the source from here, but here is perhaps room for automation in the future if we want to publish that granular level of detail in docs

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@LutaoX your call, but my drive by: the API level detail is important because the per-role boundaries are not totally clean/intuitive, and the API level will be even more important as we ship custom roles.


### Frequently Asked Questions
The new users receive an email with a link to accept the invitation and complete their setup. The new user must use this
link to sign up to be added to your account unless the account has a SAML configuration. If your account has a SAML
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I inferred this from the previous statement of "If they have SAML setup, they can ignore the invitation email." Is this true? @LutaoX

What happens when you add users to Temporal app in your SAML IdP, but you don't invite them in Temporal?

@lennessyy
Copy link
Contributor Author

We have a big warning currently that I've broken down into smaller parts so it's more digestible and less jarring. But there is one sentence here:

Important: Do not create a Gmail account when creating a Google Account.

This one doesn't have any context to me, so I've removed it. Do you know what this warning could be about so I can word it better? @LutaoX

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants